home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / next.lha / INSTALL < prev    next >
Text File  |  1993-11-23  |  6KB  |  135 lines
  1.  
  2. NOTE: This file is autogenerated from the Geomview manual.
  3.   For references to things not in this file, see the manual.
  4.   The manual is distributed in the "doc" subdirectory.
  5.  
  6.  
  7. Installing the NeXT Binary Distribution
  8. =======================================
  9.  
  10.  
  11.   1. If you have just obtained a copy of the NeXTStep binary distribution
  12.      (file `geomview-next.tar'), you can unpack it by double-clicking on
  13.      it in the Workspace.  This will open up a File Viewer panel showing,
  14.      among other things, a NeXT Installer package called `Geomview.pkg'.
  15.  
  16.  
  17.   2. The first thing you should do is double-click on `Geomview.pkg' to
  18.      invoke the NeXT Installer.  You will be asked where you want to install
  19.      it; typically it should go in `/LocalApps' or in `~/Apps' in
  20.      your home directory.  You should now be able to run Geomview and make
  21.      use of most of its features by double-clicking on the installed
  22.      `Geomview.app' icon.
  23.  
  24.   3. There are some aspects of the installation, however, that the NeXT
  25.      Installer can't handle.  In order to fully install Geomview so that you
  26.      can use all of its features, you should run the `install' script in
  27.      the `Geomview.app' directory. In particular, you must go through
  28.      this installation procedure in order to use Geomview to display
  29.      Mathematica graphics.
  30.  
  31.      To run the `install' script you can open `Geomview.app' in the
  32.      Workspace by selecting it and picking `File->Open as Folder' from
  33.      the Workspace menu.  This will pop up a File Viewer panel showing the
  34.      contents of `Geomview.app'.  Scroll down to the file named
  35.      `install', and double-click on it.  This will open a terminal
  36.      window and run the script in that window.  Alternately, you can open a
  37.      terminal window yourself, cd to `Geomview.app', and run
  38.      `install' there.
  39.  
  40.      The `install' script does the installation after asking you several
  41.      questions about where you want to install the various components of
  42.      Geomview.  After running the `install' script, Geomview is
  43.      completely installed.  If in the future you move `Geomview.app' to
  44.      some other location you should run `install' again.
  45.  
  46.   4. This step is optional.  Geomview's example data files are in the
  47.      `Geomview.app/data' directory.  If you are on a network with both
  48.      SGI workstations and NeXTStep workstations, and you want to install
  49.      Geomview to run on both, you can save disk space by having the two
  50.      installations share a common data directory.  To do this, decide on a
  51.      location for the data directory and copy it there if it isn't there
  52.      already (a good choice would be to leave it in the `$GEOMROOT'
  53.      directory in your SGI Geomview installation).  Then edit the file
  54.      `Geomview.app/CONFIG.gv' to change the setting of the variable
  55.      `GEOMVIEW_DATA' to point to this directory (there are comments in
  56.      the file telling you what to do).  You can then remove the data
  57.      directory from `Geomview.app'.
  58.  
  59.  
  60. To run geomview, double-click on `Geomview.app' from the workspace,
  61. or type `open Geomview.app' from the appropriate directory, or type
  62. `geomview' from a shell window.
  63.  
  64. More Geomview documentation is in the `Geomview.app/doc'
  65. subdirectory.  In particular, a copy of the manual is there.
  66.  
  67. The `install' script puts copies of the files in
  68. `Geomview.app/bin/next' and `Geomview.app/man' into the
  69. directories you specified for executables and man pages, respectively.
  70. Once you have done the installation you can cut down one the disk space
  71. required by Geomview by removing all the files in these directories,
  72. since copies have been installed elsewhere.  You should first test that
  73. your installed Geomview works properly because once you remove these
  74. files from their distribution directories you will not be able to do the
  75. installation again.
  76.  
  77.  
  78. Details of the NeXTStep Binary Installation
  79. -------------------------------------------
  80.  
  81. Other than the installation of the `Geomview.app' directory, the
  82. installation details of the NeXTStep binary distribution are the same as
  83. for the SGI distribution, *Note SGI Binary Detail::.  Note that the
  84. directory referred to in the SGI distribution as `$GEOMROOT'
  85. is the `Geomview.app' directory in the NeXTStep distribution.
  86.  
  87.  
  88. Details of the SGI Binary Installation
  89. --------------------------------------
  90.  
  91. The `install' script should be self-explanatory; just run it and
  92. answer the questions.  This section gives some details for system
  93. administrators and other users who may want to know more about the
  94. installation. 
  95.  
  96. The installation is actually done by `make'; the `install'
  97. script queries the user for the settings of the following `make'
  98. variables and then invokes `make install'.
  99.  
  100.  
  101. `GEOMROOT':
  102.      the absolute pathname of the Geomview root directory.  The
  103.      `geomview' shell script, which is what users invoke to run
  104.      Geomview, uses this to set various environment variables that Geomview
  105.      needs.  It is very important that this be an *absolute* pathname
  106.      --- i.e. it should start with a '/'.
  107.  
  108. `BINDIR':
  109.      a directory where executable files are installed.  The `geomview'
  110.      shell script goes here, as well as various other auxiliary programs that
  111.      can be used in conjunction with `geomview'.  This should be a
  112.      directory that is on users' `$path'.  These auxiliary programs are
  113.      distributed in the `$GEOMROOT/bin/sgi' directory; if you specify
  114.      this directory for `BINDIR', they are left in that directory.
  115.  
  116. `MANDIR':
  117.      a directory where Unix manual pages are installed.  These are
  118.      distributed in the `$GEOMROOT/man' subdirectory; if you specify
  119.      this directory for `MANDIR', they are left in that directory.
  120.  
  121. `MMAPACKAGEDIR':
  122.      a directory where Mathematica packages are installed.  This should be a
  123.      directory that Mathematica searches for packages that it loads; you can
  124.      see what directories your Mathematica searches by looking at the value
  125.      of the `$Path' variable in a Mathematica session.  The
  126.      installation process will install some packages there which allow you to
  127.      use Geomview to display Mathematica graphics.  These packages are
  128.      distributed in the `$GEOMROOT/mathematica' subdirectory; if you
  129.      specify this directory for `MMAPACKAGEDIR', or if you specify the
  130.      empty string for `MMAPACKAGEDIR', the packages are left in that
  131.      directory.  For more details about the way these Mathematica packages
  132.      connect to Geomview, *Note Package Installation::.
  133.  
  134.  
  135.